home *** CD-ROM | disk | FTP | other *** search
/ BMUG Revelations / BMUG Revelations.toast / Utilities / System Utility / InvisiFile / InvisiFile Docs < prev    next >
Text File  |  1988-07-20  |  8KB  |  100 lines

  1. ________ ___________ ______ _____ ____  _ _  _     _     _        _       _
  2. |                        _____________                      
  3. |                        I N V I S I F I L E                         
  4. |                        ``````````````````````````                         
  5. |             VERSION 1.0 © 1988 by Robert S. T. Gibson             
  6. |________ _________ ____ _____ __ ___ __   _   _     _       _         _        _
  7.  
  8. InvisiFile is a utility which allows the user to make different files... INVISIBLE. Wow.
  9.  
  10. History:
  11. =-=-=-=
  12.  
  13. Well, it doesn’t sound like much, but if you are a Macintosh owner (which you probably are, if you are reading this), then you should know what I mean when I say that System folders get REALLY messy with junk that you don’t want to have to look at. You just want them to be there, and that’s it. Sure, I have seen some people with nicely groomed System folders, but they are a minority group. I started off trying to keep things clean, but eventually I just tossed things into place, not caring how the arrangement appealed to the curious onlooker. Eventually, though, I had to find something in that mess for an update. I knew it was there, but I couldn’t even get the window large enough to see everything. Piles were atop other piles. I had to take put everything into a separate folder one by one until I found what I was looking for. Of course, it was at the very bottom of the mess.
  14.  
  15. Other people nearby also complained about this problem, so I decided to write a program to allow them to easily hide these files and keep things neat and tidy.
  16.  
  17. Okay, enough of my history. Here are the instructions. I am not going to insult you by explaining the basics. I hate that, and I know you do too. If, for some reason, you don’t know the basics of the Macintosh, read on anyway, for it will give you some insight.
  18.  
  19. The basics:
  20. =-=-=-=-=-=
  21.  
  22. Firstly, I must tell you that this program is meant for those with a system supporting the HFS file manager (Macintosh 512KE+). If you find that the main dialog box does not look right (overlapping entities), then your version of the System software is either too old, or so new that I have not been able to test it.
  23.  
  24. Secondly, I will inform you that the pictures in the main dialog box and the About box require the Helvetica font. If they look really nasty, Helvetica is either not installed in all sizes that InvisiFile needs, or it is not installed at all.
  25.  
  26. And now, how to run InvisiFile...
  27.  
  28. Running InvisiFile:
  29. =-=-=-=-=--=-=-=
  30.  
  31. First, double click on the pretty little icon—no, I promised I wouldn’t do that...
  32.  
  33. When you have opened InvisiFile, you will see a dialog box (above, it was referred to as the main dialog box, and will remain so named below). Several buttons line the side of the dialog. They are fairly self-explanatory, so I won’t explain them. You will notice that each button has a command key equivalent. Just hold down the command key hit the appropriate character, and bango! Also, you can select the default button (outlined in black, of course) which changes with the selection by pressing the return or enter key.  Note that the “Open folder” button is only enabled when, of course, a folder is selected. If you type the command key equivalent of a disabled button, it will not be registered, and will be treated as a standard keydown event for the list.
  34.  
  35. The small check boxes at the bottom might need some clarification. When these are checked, the appropriate files are displayed in the list. For example, if you choose the “Show invisibles” button, then each file displayed will be invisible, and those files in the current directory which are visible will not be displayed. The converse applies to the “Show visibles” button. If both are checked, all files will be displayed, and if neither is checked, only the folders will be displayed (folders are always shown in InvisiFile).
  36.  
  37. Well, those are about all the instructions that you will need on InvisiFile. Now, all that is left is for you to try it out and clean up your System folder a bit, so if you have any visitors, you can be proud to show it to them. It is also a good way to hide your favourite programs which you don’t want to have to trade with anyone who looks at your file. You might want to use this to hide important documents or files from others who might want to use your Mac, Although it is not much protection against this, it is much easier than taking the disk with you (especially if it is a hard drive).
  38.  
  39. Future ideas:
  40. =-=-=-=-=-=
  41.  
  42. Well, I have a few ideas for this program in the future:
  43.  
  44. • Fix the bugs listed below,
  45.  
  46. • Make entire folders of files visible or invisible,
  47.  
  48. • Let you move files without making them visible again,
  49.  
  50. • Many other things... Hopefully...
  51.  
  52. • Anything you suggest... All suggestions and comments are most welcome, and very much needed!
  53.  
  54. If enough people suggest it, I will include a button to toggle the default button on or off. Right now, though, things are cluttered up enough on the dialog box (better here than in your System folder), so I shall wait and see. If you want this, please say so. Maybe a preferences dialog box including your ideas as well... Just remember not to go slamming around that return key all the time.
  55.  
  56. Customizing:
  57. =-=-=-=-=-=
  58.  
  59. The only things that you can really customize are contained within the resource fork of this program. Most are straightforward, but the command key equivalents require a bit of explanation. To use these, you must change the letter in the button in ‘DITL’ resource 2000 to the command key you want (for appearance’s sake). Then, open up STR# 1004 and change the first character of the appropriate string to the LOWER CASE...uh, lower case... of your custom command key. That is, if you want the “Make invisible” button to be command-K, the letter in the button should be “K” and in the string, it should be “k”. If it is a non-letter character, use the unshifted version of your command key in the string (ie. I used “?” as the command key equivalent for the “About...” button, and placed “/” in the string).
  60.  
  61. The resources are all documented to a sufficient extent so you can tell what you are changing.
  62.  
  63. One note, though... DO NOT change any aspect of the About box, the “name tag” in the main dialog, or any other entities crediting the program to myself or showing its name. Change everything else to your own liking, but remember: it is STILL my program.
  64.  
  65. Bugs and problems:
  66. =-=-=-=-=-=-=-=-=
  67.  
  68. There is only one known bug (along with some VERY small fix-ups that you won’t even notice) in this program:
  69.  
  70. • When running MultiFinder with another program in use (InvisiFile is the second), if I call an alert box with paramText(anyString,'','','');, I only get a pair of “r”s. Any ideas on that one?
  71.  
  72. • I am afraid that I cannot test everything. I have no access to machines below or above the 128K ROM. If you find any bugs in these, please let me know... Thanks.
  73.  
  74. I will NOT be held responsible for any damages incurred to software or hardware as a cause of using InvisiFile... Not that I am saying anything will.
  75.  
  76. Final statement:
  77. =-=-=-=-=-=-=-=
  78.  
  79. I know you’ve heard it too many times, but this program is ShareWare. If you like this program, and/or use it (you don’t have to like it to use it), please send me $5.00 (or more, if you insist) at:
  80.               RR#1 Carrying Place,
  81.               Ontario, CANADA.
  82.               KØK 1LØ.
  83.  
  84. It is a small fee for what I think is a good cause. Thank you for your support.
  85.  
  86. This program MAY NOT be sold by itself or as part of a commercial package without the author’s permission (meaning mine). That doesn’t mean I won’t give it. I just want to be asked first. It may, however, be distributed on bulletin boards, through user groups, passed from person to person, and the like. I can accept that it could be distributed by Public Domain and ShareWare distributors such as Educorp as well.
  87.  
  88. You may distribute it freely. Free meaning no payment for the software portion (copying and disk costs excluded), and free meaning don’t feel held back from giving it away.
  89.  
  90. As I mentioned above, please send me feedback, as well! I would really appreciate hearing from you!
  91.  
  92. Thank you, and have fun InvisiFilizing things!
  93.  
  94. Rob Gibson
  95. CIS ID: 71261,2236
  96. GEnie: JGibson4
  97.  
  98. July 19, 1988.
  99.  
  100.